home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / comm / misc / PalmBackup.readme < prev    next >
Text File  |  1999-03-02  |  11KB  |  315 lines
  1. Short:    0.18 - Backup/Restore/Install for PalmPilot
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Version:  0.18
  5. Type:     comm/misc
  6. Date:     Sat Feb 13 14:31:41 1999
  7. Requires: util/libs/PalmLink.lha
  8. Www:      http://amiga.com.pl/
  9.  
  10.  
  11.  If you own an Amiga and 3Com's Palm Pilot Personal, Palm Pilot Professional,
  12.  Palm III organizer, IBM's WorkPad or derivatives, this software is for you!.
  13.  
  14.  
  15.  INTRODUCTION
  16.  --------------------
  17.  
  18.  During the development of our PalmSuite for Amiga software, the PalmLink
  19.  library was released. As we needed to find out if that library gives
  20.  us any gain compared to our connection stack, we quickly adapted some
  21.  tools we got here, to use PalmLink library. The PalmBackup is the
  22.  result of that.
  23.  
  24.  
  25.  FUNCTIONALITY
  26.  --------------------
  27.  
  28.  This is not intended to be neither a demo version of PalmSuite nor the
  29.  evaluation release of any part of it. It's just the quick PalmLink
  30.  tester ;-)
  31.  
  32.  PalmBackup features:
  33.  
  34.   · backup of organiser databases
  35.   · restore
  36.   · multi user support
  37.   · internal cache system (once you list your unit, PalmBackup will
  38.     keep the list of the remote files).
  39.   · advanced manager for installing, removing, purging etc
  40.  
  41.  
  42.  QUICK TOUR
  43.  -----------
  44.  
  45.   How to start using PalmBackup:
  46.  
  47.    · download PalmBackup and PalmLink
  48.    · unpack to any directory (no need of further installation)
  49.    · launch it
  50.    · enter the user editor (via menu, or by clicking 'faces' on toolbar)
  51.    · add yourself to the user list.
  52.  
  53.      NOTE:  if your unit is already personalised, you MUST enter
  54.             the same name your unit belongs to, otherwise you won't
  55.             be able to backup/restore anything!
  56.  
  57.      NOTE2: if your unit is not personalised yet, pick up the name
  58.             you want it to be personalised to, because PalmBackup will
  59.             set up the owner while next Backup/Restore operation!
  60.  
  61.    · select yourself as 'default profile'.
  62.    · accept changes and leave the user editor
  63.    · select "Project/Select user" and pick up your name
  64.    · enter "Settings/Backup"
  65.    · click "Scan" to fetch list of available databases
  66.    · when done, build the list of files you care about.
  67.      We suggest to add all "Generic" databases (those which
  68.      got "Backup on HotSync" flag set), and make sure 
  69.      "ToDoDB", "AddressDB", "DateBookDB" and "MemoDB" are on
  70.      the backup list (if not, add them by hand).
  71.    · accept changes you've made by clicking "OK". Now you 
  72.      are ready to backup your databases.
  73.  
  74.  
  75.   To backup selected files:
  76.  
  77.    · put your unit in the craddle
  78.    · press "Backup" icon -> you'll see the list of files to bacup
  79.    · press "Backup all"
  80.    · press "HotSync" button when requested
  81.    · wait till backup is finished
  82.  
  83.       NOTE: every database will be purged after backup (usual
  84.             behaviour)
  85.  
  86.  
  87.  To restore *whole* backup (restoration of single files is possible, but
  88.  not in easy way, see below. Sorry):
  89.  
  90.    · select the backup you want
  91.    · click "Restore" button to see the list of files you are going
  92.      to restore
  93.    · press "Restore all"
  94.    · press "HotSync" button when requested
  95.    · wait till restore is completed
  96.  
  97.  
  98.  To install any software/files:
  99.  
  100.    · select "Project/Manager" menu item
  101.    · using the left panel browse to the directory you got the files to install
  102.      (yes, we know that panel sucks, but as I said, it's quick hack - PalmSuite
  103.      offers 'normal' panels and more features - consider ordering!)
  104.    · select the file(s) you want to install
  105.    · press "Install"
  106.    · press "HotSync" button when requested
  107.    · wait till transfer is completed 
  108.  
  109.        NOTE:  the cache is not updated when you play in Manager, so you won't
  110.               see your newly installed file unless you reScan the list ("Scan"
  111.               button)!
  112.  
  113.        NOTE2: if you want to restore single file from your backup, browse
  114.               to your user directory (in "PalmPilotData"), enter "Day"
  115.               then "Time" subdirs, select database you want to be restored
  116.               and "Install" it as described above.
  117.  
  118.  
  119.  To fetch (backup) single file(s):
  120.  
  121.    · select them on the right panel list
  122.    · select destination directory in the left panel
  123.    · press "Fetch"
  124.    · press "HotSync" button when requested
  125.    · wait till finished
  126.  
  127.  
  128.  To delete any software/files:
  129.  
  130.    · select them on the right panel list
  131.    · press "Delete"
  132.    · confirm (or not) the operation
  133.  
  134.        MOTE: this cannot be undone unless you got
  135.              your victims backuped!
  136.  
  137.    · press "HotSync" button when requested
  138.    · wait till finished
  139.  
  140.  To purge (remove records marked as deleted) any database:
  141.  
  142.    · select them on the right panel list
  143.    · press "Purge" (there's NO confirmation requester!)
  144.  
  145.        MOTE: these purged records cannot be restored unless
  146.              you've got your victims backuped! But that's usually
  147.              not a problem ;-)
  148.  
  149.    · press "HotSync" button when requested
  150.    · wait till finished
  151.  
  152.  
  153.  CONFIGURATION
  154.  --------------------
  155.  
  156.  By default PalmBackup uses serial.device unit 0 at 57600 baud.
  157.  If you want it to use something different (your own MFC, HC etc
  158.  I/O cards), there're 3 environmental variables you should set:
  159.  
  160.   palmbackup_device  - name of the device you want to use
  161.                        (e.g. "duart.device")
  162.   palmbackup_unit    - unit of the device (e.g. "1")
  163.   palmbackup_maxbaud - maximum allowed speed of the connection
  164.                        (e.g. try "115200" for I/O cards ;-).
  165.                        More than "57600" makes no sense for
  166.                        serial.device.
  167.  
  168.  These variables are read every time the connection is going
  169.  to be establised, so you don't need to relaunch PalmBackup
  170.  if you change any of these variables.
  171.  
  172.  
  173.  BUGS
  174.  --------------------
  175.  
  176.  It works quite stable, but you may encounter some strange behaviour if
  177.  you play with user editor too heavily. This will of course be fixed in
  178.  PalmSuite. Sometimes cache is getting purged on exit.
  179.  
  180.  
  181.  REQUIREMENTS
  182.  --------------------
  183.  
  184.   · AmigaOS 2.x or better
  185.   · PalmPilot organiser (or derivatives)
  186.   · MUI 3.8 or better
  187.   · PalmLink.library
  188.  
  189.  
  190.  CONTACT
  191.  --------------------
  192.  
  193.   W.F.M.H.
  194.   ul. Radomska 38
  195.   71-002 Szczecin
  196.   Poland
  197.  
  198.   e-mail: carlos@amiga.com.pl
  199.   www:    http://amiga.com.pl/
  200.  
  201.  
  202.  COPYRIGHTS
  203.  --------------------
  204.  
  205.  PalmBackup is written by Marcin Orlowski and is copyrighted by Marcin
  206.  Orlowski and W.F.M.H.  
  207.  
  208.  You may copy and distribute verbatim copies of the programs' executable
  209.  code and documentation as you receive it, in any medium, provided that you
  210.  conspicuously and appropriately publish only the original, unmodified
  211.  programs, with all copyright notices and disclaimers of warranty intact and
  212.  including all the accompanying documentation, example files and anything
  213.  else that came with the original.
  214.  
  215.  You may not copy and/or distribute these programs without the accompanying
  216.  documentation and other additional files that came with the original.  You
  217.  may not copy and/or distribute modified versions of these programs as well
  218.  as you are not allowed to modify both binaries and documentation files
  219.  
  220.  You may not disassemble, decompile, re-source or otherwise reverse engineer
  221.  the programs.
  222.  
  223.  If you wish to incorporate parts of the programs into other programs, write
  224.  to the author to ask for written permission.
  225.  
  226.  You agree to cease distributing the programs and data involved if requested
  227.  to do so by the author.
  228.  
  229.  
  230.  NO WARRANTY
  231.  --------------------
  232.  
  233.  There is no warranty for the programs, to the extent permitted by
  234.  applicable law.  Except when otherwise stated in writing the copyright
  235.  holder and/or other parties provide the programs "as is" without warranty
  236.  of any kind, either expressed or implied, including, but not limited to,
  237.  the implied warranties of merchantability and fitness for a particular
  238.  purpose.  The entire risk as to the quality and performance of the programs
  239.  is with you.  Should the programs prove defective, you assume the cost of
  240.  all necessary servicing, repair or correction.
  241.  
  242.  In no event unless required by applicable law or agreed to in writing will
  243.  any copyright holder, or any other party who may redistribute the programs
  244.  as permitted above, be liable to you for damages, including any general,
  245.  special, incidental or consequential damages arising out of the use or
  246.  inability to use the programs (including but not limited to loss of data or
  247.  data being rendered inaccurate or losses sustained by you or third parties
  248.  or a failure of the programs to operate with any other programs), even if
  249.  such holder or other party has been advised of the possibility of such
  250.  damages.
  251.  
  252.  
  253.  DISCLAIMER
  254.  ---------------
  255.  
  256.  No warranty, either express or implied, is made with respect to the fitness
  257.  or merchantability of PalmBackup
  258.  
  259.  The author, reserves the right to not develop any future versions of
  260.  PalmBackup, nor to attempt at correcting any problems if any are
  261.  discovered in PalmBackup (order PalmSuite!)
  262.  
  263.  The author neither assumes nor accepts any responsibility for the use or
  264.  misuse of these programs.  He also will not be held liable for damages or
  265.  any compensation due to loss of profit or any other damages arising out of
  266.  the use, or inability to use these programs.
  267.  
  268.  The author will not be liable for any damage arising from the failure of
  269.  these programs to perform as described, or any destruction of other
  270.  programs or data residing on a system attempting to run the programs.
  271.  While I know of no damaging errors, the user of these programs uses it at
  272.  his or her own risk.
  273.  
  274.  
  275.  
  276.         ___  ___  ___    ________    ___  ___  ___    ___  ___
  277.        /   \/   \/   \  /        \  /   \/   \/   \  /   \/   \
  278.       /    /    /    / /         / /    /    /    / /    /    /
  279.      /    /    /    / /    _____/ /    /    /    / /    /    /
  280.     /    /    /    / /        \  /    /    /    / /         /
  281.    /    /    /    / /         / /    /    /    / /         /
  282.   /    /    /    / /    _____/ /    /    /    / /    /    /
  283.  /    /    /    / /    /      /    /    /    / /    /    /
  284.  \___/\___/\___/ /    /       \___/\___/\___/  \___/\___/
  285.                 /    /
  286.                 \___/
  287.                          W.F.M.H. on-line
  288.  
  289.  
  290.   http://amiga.com.pl/               http://wfmh.org.pl/
  291.  
  292.  
  293. ============================= Archive contents =============================
  294.  
  295. Original  Packed Ratio    Date     Time    Name
  296. -------- ------- ----- --------- --------  -------------
  297.     1188     540 54.5% 29-Jan-99 12:46:10  PalmBackup.info
  298.     2642    1414 46.4% 13-Jan-99 14:18:54 +TB_Backup.iff
  299.     1032     605 41.3% 03-Feb-99 21:43:30 +TB_Info.iff
  300.     1086     726 33.1% 03-Feb-99 21:42:34 +TB_Manager.iff
  301.     1038     497 52.1% 30-Jan-99 22:14:38 +TB_Profile.iff
  302.     2648    1406 46.9% 13-Jan-99 14:19:22 +TB_Restore.iff
  303.     1030     669 35.0% 23-Jan-99 20:51:58 +TB_Users.iff
  304.    10236    5027 50.8% 18-Jun-97 09:03:52 +File.mcc
  305.     6612    3512 46.8% 03-Nov-98 00:33:48 +NDirlist.mcc
  306.    30964   15533 49.8% 18-Jun-97 11:48:16 +NewDirlist.mcc
  307.    22056    9378 57.4% 18-Jun-97 12:23:46 +NewDirlist.mcp
  308.    74172   33236 55.1% 13-Feb-99 14:31:16 +PalmBackup
  309.     3733    1771 52.5% 29-Jan-99 12:46:10 +PalmBackup.info
  310.    10255    3995 61.0% 13-Feb-99 14:31:42 +PalmBackup.readme
  311.     2797    1426 49.0% 29-Jan-99 12:46:10 +PalmBackup.readme.info
  312.    16820    8847 47.4% 10-Sep-98 01:38:48 +palmlink.library
  313. -------- ------- ----- --------- --------
  314.   188309   88582 52.9% 15-Feb-99 06:07:42   16 files
  315.